第05章 界面导览(上):平台侧页面
登录以后,你面对的是十来个一级页面和一堆按钮。这一章不讲原理,只做一件事:带你一个页面一个页面地认门——打开哪一页、屏幕上写着什么、点下去会发生什么。
你将学会
- 说清平台界面由哪三块拼成:顶栏、侧边栏、内容区
- 认全 10 个一级页面,知道每一个是干什么的、你多久来一次
- 看懂顶栏那个「公司切换器」为什么重要,它一变会牵动哪些页面
- 照着真实按钮文案找到动作入口:建公司、建项目、充值、看账、生成媒体、改设置
- 知道超管后台单独长什么样、为什么你的账号里看不到它
这本手册把「界面导览」拆成了上下两章。你在平台首页登录后看到的这些页面(数据面板、公司管理、项目管理、账本、设置……)全部属于平台侧,是本章的范围;而你点进某个具体项目以后,左侧多出来的那一截菜单(智能体、自动运营、连接器……)属于项目内页面,是第 06 章的范围。两章合起来,才是完整的产品地图。
一、平台侧页面全景:一张地图
先忘掉细节。任何一个平台侧页面,屏幕都被切成三块:上面一条顶栏,左边一条侧边栏,中间一大片内容区。你所有的操作都发生在这三块里。
三块里只有中间那块会随页面切换而变。顶栏和侧边栏从你登录那一刻起就在,是你「不迷路」的两个锚点——不知道自己在哪时,先看侧边栏哪一项被高亮。
10 个一级页面,一眼认全
侧边栏从上到下的常显项固定在 9 个,加上只有超管能看到的第 10 个,一共 10 个一级页面。先混个脸熟,下面几节再逐个展开。
| 侧边栏文案 | 路径 | 它是干什么的 | 你多久来一次 |
|---|---|---|---|
| 数据面板 | /dashboard | 登录后的落地页,看项目数、预算消耗、任务状态、最近活动。 | 每次登录先扫一眼 |
| 公司管理 | /company | 建公司、看组织架构、管成员、发邀请、改公司设置。 | 建公司时集中来,之后偶尔 |
| 项目管理 | /project | 建项目、看项目卡片、做连接测试,是进各个项目的总入口。 | 几乎每次都要路过 |
| 知识库 | /kb | 分层知识库(公司级 → 项目级)、上传文档、RAG 检索。 | 导资料时集中来 |
| AI 对话 | /chat | 平台级的多轮对话,可以上传文件、看思维过程和工具调用。 | 按需 |
| 公司账本 | /ledger | 真金白银的账户流水:充值、消费、预警阈值。 | 充值 / 对账时来 |
| 媒体生成 | /media | 生成视频 / 图像 / 歌曲,看任务记录与价目设置。 | 做素材时来 |
| 通知中心 | /notifications | 系统推给你的所有消息:预算预警、审批请求、任务完成…… | 每天扫一遍 |
| 设置 | /settings | 个人设置、Agent 优化、功能管理、授权管理。 | 配置期集中来 |
| 超管后台 仅超管 |
/admin/dashboard | 全局看板、用户管理、项目穿透、实例监控、Token 统计、Prompt 审计、治理审计。 | 只有平台运营方用 |
侧边栏最下面的「超管后台」只对超级管理员显示。如果你是普通企业用户,看不到它是正常的,不是你的账号出了问题。这一章的第十节会讲它长什么样,你可以当背景知识看,也可以直接跳过。
为什么侧边栏会「时多时少」
很多新手第一次遇到这种情况会慌:刚登录时侧边栏只有十来项,点进一个项目之后,突然从「项目管理」下面冒出来 6 个分组。这不是 bug,而是设计:
没进项目时(平台视角)
侧边栏只显示 9 个一级页面 + 超管后台。这时的你站在「公司」这一层,管的是组织、项目清单、账本、设置。
进了某个项目时(项目视角)
在「项目管理」和「知识库」之间会插入 6 个分组菜单(建项与定义、组织与运营、接入与执行、研究与获客、治理与资源、运维与报告),整条侧边栏一下子长出一大截。
判断「我现在在哪一层」有一个特别简单的办法:看侧边栏有没有那 6 个分组。有,说明你已经在某个项目里了,你接下来的操作只影响这一个项目;没有,说明你还在平台层。
进阶:这 6 个分组菜单,什么时候才会出现
它们出现的条件是当前网址里带着项目号——也就是形如 /project/123/... 这样的路径。你从「项目管理」点进一个具体项目时,网址就会带上这个项目号,侧边栏随之展开。返回平台层(比如点「数据面板」)后,网址里的项目号消失,那 6 个分组也就收起来了。
另外有一个细节:当你离开项目、回到平台层时,系统会顺手把「当前选中项目」清空,避免你在账本页看到的还是上一个项目的数据。所以从项目里退出来之后,账本等页面会自动切回公司视角,这是对的,不是丢数据。
二、全局框架:顶栏、侧边栏与面包屑
这一节讲三块里「永远在」的部分。它们不随页面变,但每个都跟你的日常操作强相关,尤其是公司切换器。
顶栏,从左到右
| 控件 | 界面文案 | 点下去会怎样 |
|---|---|---|
| 折叠按钮 | 图标(无文字),悬停提示折叠 / 展开 | 把左侧菜单收成只有图标的一条窄栏,给内容区腾地方。状态会记住,刷新后还是收着的。 |
| 公司切换器 | 占位符 选择公司,下拉第一项 全部公司 | 切换当前公司。见下一节,这是本章最重要的一个控件。 |
| 通知铃铛 | 铃铛图标,有未读时带角标 | 弹出一个小面板,标题「通知」,里面有 全部已读(有未读时才出现)和 查看全部;没消息时显示 暂无通知。 |
| 主题切换 | 悬停提示 切换暗色 / 切换亮色 | 在亮色和暗色主题间来回切。选择会记住,下次打开还是这个主题。 |
| 用户菜单 | 头像 / 用户名 | 下拉四项:通知中心、个人中心、设置、退出登录(这一项与上面隔了一条分隔线,防止误点)。 |
通知面板里的时间显示很贴心:刚发生的显示「刚刚」,最近一小时内显示「N 分钟前」,当天显示「N 小时前」,更早显示「N 天前」,再早一点就直接显示「月/日」。所以你看一眼就知道哪条是新的。
未读条数不用你手动刷新,页面会每隔 30 秒自动去查一次。所以你在别的标签页里处理完一条通知,回到这个页面时角标很快就跟上了。
公司切换器:全平台最该先搞懂的一个控件
这个下拉框决定了「你现在以哪家公司的身份在操作」。它有三个状态,含义完全不同:
全部公司
下拉里的第一项,对应数值 0。选了它,数据面板显示的会是你能看到的所有公司汇总。
某一家具体公司
选了它,知识库、项目管理、功能管理等页面都会以这家公司为范围,新建资源也会挂到它名下。
还没选(未选择)
首次登录 / 刚清过选择时是空的状态。这时很多页面会提示你「先选公司」,按钮也是灰的。
它之所以关键,是因为下面这几个页面的「可用性」直接取决于它有没有被选中:
- 知识库:没选公司时,列表直接显示 请先在顶部选择公司,新建知识库 也是灰的。
- 项目管理:没选公司时,顶部挂着一条橙色提示 请先选择或创建一个公司,新建项目 点不动。
- 公司管理:后面四个页签(组织架构 / 成员管理 / 成员邀请 / 公司设置)全部变灰,只有「公司列表」可看。
- 设置 → 功能管理:没选公司时提示 请先在顶部选择公司。
你在 A 公司里点进了一个项目,此时「当前选中项目」记着这个项目。如果你在顶栏把公司切换到 B 公司,系统会立刻清空这个记录——因为那个项目根本不属于 B 公司,留着它只会让账本之类的页面显示错乱。所以切完公司以后,如果相关页面变回「公司视角」,是正常行为。记住一句话:换公司等于换上下文,先把公司选对,再进项目。
面包屑:你的「来路」指示牌
内容区顶部有一行小小的导航,形如「首页 / 公司管理 / ……」,用斜杠分隔。第一项永远固定是首页,往后是当前页面所在的路由层级。每一段都可以点,点过去就回到那一层。
有一个小规矩要知道:进入 AI 对话 页时,这行面包屑是不显示的。因为对话页是满屏三栏布局,顶部再塞一行导航会挤。这不是坏了。
授权横幅:如果你看到红条或黄条
在顶栏上方,有时会多出一条横幅,只在授权相关的情况下出现:
| 颜色 | 界面原文 | 含义 |
|---|---|---|
| 红 | 未激活授权,系统将在 … 后自动关闭 | 还在试用、没激活。倒计时不足 1 分钟时会显示「即将关闭」,请尽快去「设置 → 授权管理」激活。 |
| 黄 | 网络异常,已按上次激活延期运行至 … | 离线宽限:系统暂时连不上授权服务器,按上次激活的状态继续跑一段时间,期间功能不受影响。 |
红条不是装饰。倒计时走完,系统会自动关闭。处理方法在「设置 → 授权管理」:把授权码填进 请输入授权码,点 激活。授权码从哪来,问给你开通服务的人。
浏览器的标签页标题也是导航
每切换一个页面,浏览器标签页上的文字会跟着变成「页面名 - ZY 企业智能引擎」。开着好几个标签页时,扫一眼标签就知道哪个是哪个页面。列表页的标题取自各页面自己的名称,比如「数据面板」「公司管理」「项目账本」,超管页面则会在名字后面缀上「(超管)」三个字。
三、数据面板:登录后的第一眼
登录成功以后,默认落到这一页。它的定位是「一眼看清全局」,所以内容非常克制,只有四张指标卡 + 两块活动区域。
你会看到什么
页面顶部是一句欢迎语 欢迎回来,你的用户名,下面一行小字说明 这里是你的全局数据面板,后续可自定义展示模块。 注意「后续可自定义」这个说法——说明这个面板未来会开放模块自定义,当前版本是固定布局。
接着是四张指标卡(四列排开):
再往下分左右两块:左边是图表卡「项目活动趋势」,右边是列表卡「最近活动」。
| 区域 | 加载中显示 | 没有数据时显示 |
|---|---|---|
| 项目活动趋势(图表) | 加载图表数据... | 暂无活动数据 |
| 最近活动(列表) | — | 暂无项目活动 |
新账号没有任何项目时,这两块注定是空的——它们显示的是 暂无活动数据 和 暂无项目活动,这是正常的。等你建了公司、建了项目、项目开始跑任务,图表和列表就会自己长出来。
这是数据没拉回来的兜底文案。多数情况下是网络抖动或后端一时忙,刷新一下页面通常就好。如果连续几次都失败,去看看「通知中心」有没有系统通知,或换个时间再试。
四、公司管理:你的组织容器
这一页用五个页签把「公司」这件事分成了五块:公司列表、组织架构、成员管理、成员邀请、公司设置。建公司的操作在第 02 章讲得很细,这里只讲界面怎么认。
五个页签
| 页签 | 它在管什么 | 什么时候能用 |
|---|---|---|
| 公司列表 | 你名下(或有权限看到的)所有公司的清单。 | 永远可用 |
| 组织架构 | 公司内部的部门与层级结构。 | 需先选中公司 |
| 成员管理 | 查看成员、调整角色与权限。 | 需先选中公司 |
| 成员邀请 | 生成邀请、把同事拉进来。 | 需先选中公司 |
| 公司设置 | 公司的基础信息设置。 | 需先选中一家具体公司 |
后四个页签(组织架构 / 成员管理 / 成员邀请 / 公司设置)在没有选中任何一家公司时是禁用的,视觉上是灰的、点不动。先去「公司列表」点某一行的 进入,或点这一行的 设置,选中之后它们就亮了。「公司设置」比另外三个更严格一点——必须选中一家具体的公司才解锁。
公司列表页长什么样
标题区左边写着 我的公司,右边一个蓝色按钮 创建公司。
| 列名 | 里面放什么 |
|---|---|
| 公司名称 | 你建公司时填的名字 |
| 行业 | 公司所属行业 |
| 描述 | 一句话简介,太长会省略,悬停可看全 |
| 状态 | 只有两种:正常 或 已停用 |
| 操作 | 两个文字按钮:进入 和 设置 |
如果一家公司都还没建,表格位置会显示 暂无公司,点击右上角创建。这句话本身就是操作指引——它不是让你「去找」创建入口,创建入口就在右上角。
进阶:「进入」和「设置」有什么区别
进入相当于把这家公司「选中」,接下来的页面都以它为范围,并把你带到这家公司的详情上下文里;设置则直接把你送到「公司设置」那个页签,方便改基础信息。
如果你只是想把顶栏的公司切换器切到某一家,用顶栏那个下拉最快,不必在这一页绕。两者效果一致,改的都是「当前公司」这个上下文。
五、项目管理:进入每个项目的总入口
这是你使用最频繁的一个页面。它是「公司 → 项目」的最后一跳,也是本章和第 06 章之间的那道门。
页面结构
标题区左边是 项目管理,紧跟一枚小标签显示当前公司名(这样你一眼就知道自己正在哪家公司下建项目);右边是 新建项目 按钮,它旁边紧跟一个提示。
选了公司
新建项目 亮着,点下去弹出「新建项目向导」,走三步:基本信息 → 预算设定 → 确认提交。每个字段怎么填、填错有什么后果,见第 03 章。
没选公司
页面顶部挂着橙色告警 请先选择或创建一个公司,新建项目 是灰的。项目必须挂在公司下面,所以先去顶栏选一家公司。
项目卡片上有什么
每个项目展示为一张卡片,卡片上能看到:
- 项目名称——点击进入这个项目。
- 项目描述——就是建项目时填的那句。没填的话这里显示 暂无描述。
- 项目类型 / 行业 / 创建时间——用来快速区分不同项目。
- 连接测试——这是个很实用的小按钮,见下。
如果一个项目都还没有,卡片区显示 暂无项目,点击「新建项目」开始。
「连接测试」按钮:点下去会告诉你三件事
这个按钮用来验证「平台能不能连上这个项目背后的服务器」。它有三种结果,文案各不相同,看懂这三种你就知道问题出在哪一层:
| 结果 | 界面提示 | 说明什么 |
|---|---|---|
| 全通 | 连接成功:IP:端口,HMAC 验证通过(Nms) | 网络能通,签名验证也过了,这台服务器完全正常。括号里是往返耗时,越小越好。 |
| 半通 | 连通但 HMAC 验证失败:错误信息 | 网络能连到那台机器,但双方密钥对不上。通常是实例密钥不匹配,需要重新核对密钥,不是网络故障。 |
| 不通 | 连接失败:错误信息 | 连都连不上。可能是服务器没开、地址填错、端口不通。 |
HMAC 是一种「带密钥的签名」机制。平台给项目服务器下指令时,会附上一段用密钥算出来的签名;服务器收到后用自己的密钥验一遍,对得上才执行。这样即使有人截获了指令也伪造不了。「连接测试」把网络连通性和签名验证拆开报,就是为了让你一眼分清「是网不通」还是「是密钥不对」。
六、知识库:分层存放你的资料
知识库用来喂给 AI 资料。它的核心概念是分层:公司级的知识放到公司层,所有项目都能用;项目级的知识只归某一个项目;共享知识还能下发给下级。页面标题下面那句 分层知识库(公司级 → 项目级) 点明了这个顺序。
两个页签
「知识库」页签管资料本身,「RAG 检索」页签用来试查。
知识库页签右上角有 新建知识库,同样受公司切换器约束:没选公司时,整个列表显示 请先在顶部选择公司,按钮不可点。列表的列是:名称 / 类型 / 共享 / 文档数 / 分块数 / 状态 / 创建时间 / 操作,操作里有两个文字按钮 文档管理 和 删除。
点 新建知识库 弹出对话框 新建知识库,字段如下:
| 字段 | 提示文字 | 说明 |
|---|---|---|
| 名称 | 如:产品知识库 / 公司制度库 | 给知识库起个名字,最长 255 字。 |
| 描述 | 知识库用途说明(可选) | 选填,写清这个库放什么,以后好找。 |
| 类型 | 三个选项:公司级 / 项目级 / 共享 | 决定谁能用这个库。 |
| 所属项目 | 下拉,占位符 选择项目 | 只有选了「项目级」时才需要(也才会显示)。 |
| 共享下级 | 开关,旁边写着「开启后下级项目可检索到本知识库」 | 打开后,下面的项目也能查到这份资料。 |
底部是 取消 和 创建。
「公司级」是所有项目共享,「项目级」只给一个项目用,选错了会出现「别的项目查不到这份资料」或「不该看到的项目也看到了」。第一遍建库时就把类型想清楚。
RAG 检索页签
这个页签的作用是「拿一句话去知识库里试查一下」,看看你的资料有没有被 AI 检索到、相似度多高。
- 输入框占位符 输入检索关键词,如:产品定位、目标客户、营销策略。
- 旁边一个条数下拉,可选 Top 5 / 10 / 20。
- 按钮 检索。
- 查不到内容时显示 未检索到相关内容。
- 每条结果上显示 相似度 N%,数字越大表示越相关。
RAG 就是「让 AI 先翻你的资料、再回答」。它在回答前会拿你的问题去知识库里找最相关的几段文字,把它们一起交给模型。所以如果你发现 AI「答得不对」,第一步不是怪模型,而是来这个页面试一下:你的问题能不能在这里查出相似度高的结果。查不到,说明是资料没进库或标题不对;查得到但答得还差,才轮到调提问方式。
文档管理抽屉
在知识库列表里点某一行的 文档管理,右侧滑出一个抽屉,标题是 文档管理 · 知识库名字。抽屉里有 上传文档 和 刷新 两个按钮,右上角可关闭。
上传支持的文件类型是 .pdf / .txt / .md / .markdown / .docx / .xlsx。文档列表的列是:文件名 / 类型 / 状态 / 分块数 / 大小 / 上传时间 / 操作,操作里是 处理。一篇文档都没传时显示 暂无文档,点击「上传文档」添加。
文档的状态是分阶段的,含义如下(这组状态在「知识库页签的库状态」和「文档状态」上是两套,别混):
| 文档状态(中文) | 含义 |
|---|---|
| 待处理 | 文件传上来了,还没开始解析 |
| 解析中 | 正在把文件里的文字抽出来 |
| 已解析 | 文字抽完了 |
| 分块中 | 正在切成一小段一小段 |
| 向量化中 | 正在把每一段转成能「按意思搜索」的向量 |
| 就绪 | 全部完成,可以参与检索了 |
| 失败 | 中途出错,需要重新处理或换文件 |
知识库本身的状态则只有三个:正常 / 索引中 / 错误。资料导入的完整流程(包括边缘客户端怎么扫你电脑里的文件),在第 07 章。
七、AI 对话:平台级的多轮问答
这一页是满屏的三栏布局:左边是对话列表,中间是消息区,底部是输入区。顶部没有面包屑(前面讲过,是刻意的)。
三种「空白状态」要分清
新手在这一页最常见的困惑是「怎么空空如也」。其实有三个不同的空,对应三句不同的提示:
左栏没有对话
显示 暂无对话。点 新建对话 就有了。
还没打开任何对话
中间显示 选择或创建一个对话开始,下面配一个 新建对话 按钮。
对话开了但还没说话
消息区显示 开始一个新的对话,外加一行提示:输入消息或上传文件开始与 AI 助手交流。
左栏:对话列表
- 顶部 新建对话,新建的对话默认叫 新对话。
- 搜索框占位符 搜索对话...,用来在对话多的时候过滤。
- 每条对话右侧有下拉菜单,两项:重命名 和 删除。
点重命名会弹出输入框,标题 重命名对话,提示语 请输入新的对话名称,改完提示「已重命名」。点删除会先弹确认框:确定删除这个对话吗?删除后不可恢复。
中间:消息区
对话顶部显示当前对话的名称,右边挂一枚灰色小标签,显示这个对话的归属范围。注意:这个标签显示的是原始英文值(比如 project),不是中文。这是界面上的一个小瑕疵,看到英文别惊讶。
消息分两种:
你发的(右侧)
纯文本。悬停或点按钮有 复制 和 删除。
AI 回的(左侧)
内容更丰富:可能有一段可展开的「思维过程」,可能有一串工具调用卡片,然后是正文。正文下方(且状态已结束、有模型名时)会显示一行小字:模型名、耗时(毫秒 / 秒 / 分钟会自适应)、输出 token 数。操作同样是复制和删除。
工具调用卡片折叠在消息里,展开后能看到两段:参数 和 结果。卡片头部显示工具名和耗时。「思维过程」是模型在给答案前的推理草稿,默认收起,想看它「怎么想的」时可以展开。
这是刻意设计——消息还在流式生成时不允许删除,避免删到一半状态错乱。等它输出完,删除按钮就恢复可用了。
删除单条消息的确认文案是 确定删除这条消息吗?删除后不可恢复。
如果某次回复没成功(网络中断、上游服务异常等),界面上会出现一个单独的错误块:标题「本次回复未成功完成」,下面一句人话「回复未能完成(可能因网络中断或上游服务异常),请重试;若反复出现,请检查网络或查看实例状态。」。它不会再伪装成 AI 说的一段话,所以你不会把报错当成 AI 的回答。
错误块下方还有一个可折叠的「技术详情」,展开能看到底层返回的原始报错。这主要是给排障用的——日常你按上面那句话重试、或去实例状态看看就行,不必读懂那段英文。
底部:输入区
输入框占位符 输入消息... (Enter 发送, Shift+Enter 换行)。这条提示很实用:回车发送,想换行就按住 Shift 再回车。
输入框旁边有附件入口,支持的文件类型很长一串:.doc / .docx / .pdf / .txt / .md / .xlsx / .xls / .ppt / .pptx / .html / .csv / .json。上传后附件上会显示状态:已解析 / 解析中... / 解析失败。上传成功会提示「已上传: 文件名」。
AI 正在流式输出时,发送区会变成一个红色的 停止 按钮,点它可以打断这次生成。
平台级的 AI 对话和项目里那套「AI 问答」(在项目内,见第 06 章)不是同一件事。平台级对话走平台自己的通道,除非你把对话显式挂到某个项目上,否则它不会去调那个项目的服务器、也不消耗那个项目的预算与知识库。日常「问点什么」用它,「围绕项目干活」用项目内的 AI 问答。
八、公司账本:真金白银的流水
菜单里叫「公司账本」,副标题一句把人话讲透了:平台账户真实资金流水:充值、AI 算力费、云服务器费等。这一页管的是你真正充进去的钱。
产品里有两条完全不同的账:公司账本(这一页,/ledger)记的是平台账户的真实资金:你充了多少、花了多少、余额还有多少;项目账本(/project/项目号/ledger)记的是某一条业务线的虚拟核算:收入、支出、预算消耗。两者用的是同一个页面组件,靠网址里有没有项目号来决定显示哪一种。所以你会发现「从项目里点项目账本」和「从侧边栏点公司账本」长得像但内容不同——这是设计如此。项目账本那半边的细节(含「账本明细 / 智能看板」两个页签)在第 06 章。
顶部三个按钮
公司账本模式下,标题右边有三个按钮:
- 充值——给账户加钱。
- 记录消费——手工记一笔消费。
- 预警阈值——设置余额低于多少时提醒你。
四张卡:账户现状
如果余额跌破了你设的预警线,页面顶部会出现一条橙色提醒:余额 … 已低于预警阈值 …,请及时充值避免实例熔断。「实例熔断」的意思是:余额真的见底时,平台会把你项目对应的服务器停掉,防止欠费。所以这条提醒要认真对待。
交易明细表
表格标题「交易明细」,右上角有两个筛选器:全部类型(可选 充值 / 消费 / 退款)和 全部分类(可选 云服务器费 / Token 费 / 图片生成费 / 视频生成费 / 其它)。
表格的列是:时间 / 类型 / 分类 / 描述 / 关联单号 / 金额 / 余额。金额是带正负号的——进账为正、出账为负,余额那一列是这笔之后账户的余额。一条记录都没有时显示 暂无交易记录。记录多的时候底部有分页条。
三个弹窗
点顶部那三个按钮,分别弹出三个对话框:
| 弹窗标题 | 字段 | 说明与限制 |
|---|---|---|
| 账户充值 | 金额、描述、支付单号 | 金额最小 0.01、最大 1000000;描述占位符「如:在线支付充值」;支付单号选填,占位符「可选」。底部是 取消 和 确认充值。超过上限会直接被拦下,提示「单笔充值金额不能超过 1000000 元」。 |
| 记录消费 | 分类、金额、项目 ID、公司 ID、描述 | 手工记一笔账。描述占位符「如:LLM 调用消费」。底部是 取消 和 确认。 |
| 余额预警阈值 | 阈值(元) | 低于这个数就通知你。底部是 取消 和 保存。 |
三个操作成功后分别提示:充值成功 / 消费已记录 / 预警阈值已更新。
公司账本里有一个消费分类叫「Token 费」,指 AI 调用模型花的钱。这一批改动之后,项目里 AI 消耗的 token 会由项目侧按批上报给平台,计入公司账本的真实流水:平台按每批的 report_id 幂等去重,同一批不会重复扣费;上报成功才记账,失败会退避重试、不丢单;上报水位也落了库,进程重启不会重扫历史账。
页面上有一行常显说明写得很清楚:「AI 算力费由项目侧 token 计费批量上报(未开启该上报时不含此项,可在项目账本查看 AI 运行消耗)」。也就是说,只有部署时配好了上报地址的实例,公司账本才会有这项;没配上报地址的实例,公司账本里不含 AI 算力费——这是「未启用」而非「算漏了」。所以做对账前,先看这一行说明:确认上报已开启,再拿公司账本的 Token 费和项目内计费明细对照;没有开启时,AI 消耗请以项目账本的「计费明细 / 运行轮次」为准。
九、媒体生成中心:做素材的地方
页面标题 媒体生成中心,标题左边有一个 返回 按钮,点了回到项目管理。整页用五个页签切分:视频 / 图像 / 歌曲 / 任务记录 / 价目设置。
视频页签
| 字段 | 可选项 / 提示 |
|---|---|
| 提示词 | 多行输入,占位符 描述想要生成的视频画面与风格 |
| 时长(秒) | 4 到 12 之间 |
| 分辨率 | 480p 或 720p |
| 比例 | 16:9 / 9:16 / 1:1 |
按钮是 生成视频;提交后进入轮询等待,按钮变成红色的 停止,点它可以中止等待。
图像页签
- 提示词:占位符 描述想要生成的图像。
- 引擎:可选 gpt 或 seedream。
- 尺寸:输入框占位符 如 1024x1024。
- 按钮 生成图像。
歌曲页签
- 歌词:多行输入,占位符 输入歌词内容(必填)——这是必填项。
- 风格提示:占位符 描述歌曲风格、情绪等(可选)。
- 按钮 生成歌曲,等待时可点 停止。
视频和歌曲是异步生成的,界面要不停去问「好了没」。如果连续多次都问不到结果,页面不会一直傻等,而是停下来并提示 任务状态查询连续失败,已停止轮询,旁边给一个 重试查询 的链接按钮。看到它别慌,点重试查询通常就能接上。
任务记录页签
顶部有一个类型筛选(全部类型 / 视频 / 图像 / 歌曲)和一个 刷新 按钮。页面上一句提示把计费口径说得很清楚:
金额由服务端按「档位单价 × 用量」折算并计入项目账本;未定价档位显示 待定价(不折算、不谎报金额)。
表格的列是:时间 / 类型 / 状态 / 档位 / 单价(元) / 用量 / 金额(元) / 提示词。没有记录时显示 暂无媒体任务记录。任务状态共九种,含义如下:
| 状态 | 含义 |
|---|---|
| 已提交 | 请求发出去了 |
| 排队中 | 在服务端排队等资源 |
| 准备中 | 正在准备模型 / 资源 |
| 生成中 | 正在生成 |
| 已完成 | 成功产出 |
| 失败 | 生成失败 |
| 已超时 | 等太久,判定超时 |
| 已取消 | 被你手动中止 |
| 已过期 | 任务过期失效 |
价目设置页签
这一页让你给各档位定单价。顶部一条提示:
单价填 0 表示「未设置,跟随默认价」,只有填写的档位会保存为覆盖价(负价不可提交)。
档位分三组:图像(元/张:1K / 2K / 4K)、视频(元/条:480p ≤5s / 480p >5s / 720p ≤5s / 720p >5s)、音乐(元/首:单曲)。每个输入框下面会写清楚当前是「未设置,跟随默认 ¥x」还是「默认 ¥x」。底部是 保存价目 和 重新加载。
如果你是只读身份,页面会显示 当前身份为只读:价目编辑仅限公司管理员 / 项目负责人。,保存价目 也不出现。想改价,需要拿到公司管理员或项目负责人的身份。
十、通知中心:所有消息都落在这里
标题 通知中心,右上角一个 全部已读 (N) 按钮——括号里的 N 是当前未读数,只有存在未读时这个按钮才显示。
三个筛选器
页面提供三个下拉筛选,可以叠加使用:通知类型、优先级、已读状态(未读 / 已读)。
一条通知上有什么
- 一枚优先级标签(紧急 / 重要 / 普通 / 信息)。
- 一行类型标签(预算预警 / 审批请求 / 任务完成 / 营销更新 / 里程碑 / 系统通知 / 营销通知)。
- 标题与正文。
- 时间。
- 两个操作按钮:标为已读 和 删除。
一条通知都没有时显示 暂无通知。点删除会弹确认框,标题「提示」,内容是 确认删除该通知?。点「全部已读」成功后提示 已全部标记已读。
顶栏铃铛里那个小面板,显示的就是这一页通知的最近几条(加一个「查看全部」按钮跳过来)。所以你可以只在铃铛里快速扫一眼,需要批量处理时再来这一页。预算预警、审批请求这类需要你动作的消息,会在铃铛上直接加未读角标,基本不会漏。
十一、设置:四个页签
设置页是标签页布局,四个页签的顺序固定:个人设置 / Agent 优化 / 功能管理 / 授权管理。这四个里,「功能管理」和「Agent 优化」是高价值页,值得多花点时间。
个人设置
最简单的一页,两项:用户名(只读展示)和主题模式(一个开关,开启侧标「暗色」、关闭侧标「亮色」)。这个开关和顶栏那个主题切换按钮效果一样,改哪个都行。
授权管理
显示授权状态,并让你激活。展示项如下:
| 项目 | 说明 |
|---|---|
| 机器码 | 这台服务器的唯一标识,激活时要用它。没取到时显示「—」。 |
| 激活状态 | 四种之一:已激活 / 试用中(未激活)/ 离线宽限 / 已过期。 |
| 有效期 | 已激活或离线宽限时显示到期日期;试用中显示「未激活」;其余显示「—」。 |
| 上次激活时间 | 最近一次成功激活的时间。 |
| 预计关闭时间 | 只在试用或离线宽限状态下出现。 |
激活方式是:把授权码填进 请输入授权码 输入框,点 激活。输入框是空的就点,会提示 请输入授权码;激活成功会提示 激活成功。
功能管理:项目级的功能开关
这一页控制「某个项目开哪些功能」。顶部先选项目:一个下拉,占位符 请先选择项目,旁边一个 重置为默认 按钮(没选项目时不可点)。进入页面时会自动帮你选中第一个项目。
页面顺序是:基础功能卡 → 高级功能卡 → AI 智能建议卡。前两张卡里是一排排开关,每项开 / 关后提示「XX 已开启」或「XX 已关闭」。重置会提示「功能开关已重置为默认值」。
| 分组 | 包含的功能 |
|---|---|
| 基础功能 | 自动构建部署、通知中心、自动备份、自动报告、智能报告、项目模板 |
| 高级功能 | 营销自动化、战略规划、渐进式信任、冲突仲裁、资源治理、营销引擎、社交媒体运营 |
第三张卡「AI 智能建议」有点意思:说明写着 AI 根据项目当前状态和经营需求,分析应开启哪些高级功能。,点 分析项目并建议 按钮,AI 会给出一组建议,每条带一个优先级标签(高 / 中 / 低),后面跟一个 开启 按钮,或者一枚灰色的 暂不需要 标签。没有可建议的会显示 暂无建议,所有功能已根据项目状态合理配置。
手册别处会提「资源治理、预算熔断、渐进式信任属于安全底线」。在当前版本里,这事已经落到界面和后端两层:凡是带「安全底线」小标签的开关(当前是「渐进式信任」和「资源治理」两项),开关是置灰、点不动的,鼠标悬停会提示「该功能为安全底线,不允许关闭」;就算绕过界面直接调接口,后端也会拒绝,并返回「「XX」为安全底线功能,不允许关闭」。换句话说,这几项你想关也关不掉——只能保持开启。
其余开关则可以自由开 / 关。另外项目内的「组织进化 → 定量调控」里还有一套强制维度(预算、自主权限),那是另一处的安全底线,同样不可关。相关背景见第 04 章和第 08 章。
早前版本里,有些开关拨了好像没反应。现在以下 6 个开关已经真正生效:自动构建部署(deploy)、自动报告(report)、智能报告(auto_report)、营销自动化(marketing)、战略规划(strategy)、渐进式信任(trust_model)。一旦你把某个关掉,再访问对应功能(点按钮、开页面、调接口),系统会直接拒绝并给出中文提示,格式是「XX功能未启用,请在功能开关中开启 KEY」。举几个实际会撞到的例子:
- 关了
deploy,去点「自动构建部署」,会提示「自动构建部署功能未启用,请在功能开关中开启 deploy」。 - 关了
strategy,进「战略」页会提示「战略规划功能未启用,请在功能开关中开启 strategy」。 - 关了
report,看报告配置 / 历史会提示「报告配置功能未启用…」;关了auto_report,让系统自动生成并推送日报,会提示「智能报告功能未启用…」。
另外,「冲突仲裁、营销引擎、社交媒体、项目模板」这几个开关本来就在生效;只有「通知中心(notification)」这一个目前还没有接上开关门控——这是已知的未完成项,关掉它暂时不影响通知投递。
几个状态提示要知道:没选公司时显示 请先在顶部选择公司;选了公司但公司下还没有项目时,显示 请先选择一个项目以管理其功能开关;选好了项目,卡片上方会显示一行「当前配置:项目名」,提醒你别改错了项目。如果项目列表或开关本身加载失败,页面会分别弹出一条红色提示「项目列表加载失败」或「功能开关加载失败」,带上具体原因,并给一个 重试 链接——不会再静默地显示一个空列表。真的一个开关都没有(不是加载失败)时,显示「该项目暂无功能开关,可点击「重置为默认」初始化」。
进阶:功能开关的 13 个 key 与切换规则
每个功能在接口层有一个英文 key,界面显示的中文名、分组、是否「安全底线」,都以项目服务器下发的字典为唯一来源(前端只做兜底)。对照如下(想查接口文档或排查问题时用得上):
- deploy —— 自动构建部署 已生效
- notification —— 通知中心(尚未门控)
- backup —— 自动备份
- report —— 自动报告 已生效
- marketing —— 营销自动化 已生效
- strategy —— 战略规划 已生效
- trust_model —— 渐进式信任 已生效(安全底线,不可关)
- arbitrator —— 冲突仲裁
- resource_governor —— 资源治理(安全底线,不可关)
- marketing_engine —— 营销引擎(后端名为「营销自动化引擎」)
- social_media —— 社交媒体运营(后端名为「社交媒体管理」)
- auto_report —— 智能报告 已生效(与上面的「自动报告 report」是两个 key,别混)
- project_template —— 项目模板
两个容易踩的点:其一,「自动报告(report)」和「智能报告(auto_report)」是两项不同的功能——前者管报告配置与历史阅读,后者管报告的自动生成与推送,界面上已经分开显示,看到两个「报告」别以为重复了。其二,分组与显示名当前统一由后端字典决定:界面按后端下发的分组动态渲染;后端若新增了界面不认识的 key,会归到「其它」分组里,而不是裸奔一个英文 key。所以遇到「功能明明开了、页面说没启用」时,先来这里核对 key 有没有开关到位。
还有个小细节:点 重置为默认 会先弹确认框「将把该项目所有功能开关恢复为默认值,是否继续?」,确认后才执行,成功提示「功能开关已重置为默认值」——这是个破坏性操作,别手滑。
Agent 优化:让系统自己优化智能体
这一页管两件事:常规优化(到一定运行次数后自动优化某个 Agent / 技能)和深度全局优化(定时或手动,把整个项目的执行数据统计一遍再优化)。
常规优化 (Regular) 卡:说明写着「对新创建的 Agent/Skill 达到里程碑次数后自动触发优化分析。」字段有「运行次数里程碑」(默认是 3 / 10 / 40 / 200 这几个数,可以加可以删)、「自定义优化提示词」(占位符「留空使用默认模板」)、「自动应用建议」(旁边注明只自动应用非破坏性的建议,比如提示词调整)。
深度全局优化 (Deep Global) 卡字段更多:
| 字段 | 说明 |
|---|---|
| 定时执行 (Cron) | 占位符 如: 0 2 * * 0 (每周日凌晨2:00),提示「留空则仅支持手动触发」 |
| 优化深度 | 三选一:浅度 / 标准 / 深度,默认「标准」。分别对应近 30 天快速分析、近 90 天全面分析、近 180 天深度分析 |
| 单次最大费用 (¥) | 默认 10,范围 0–1000,这是给单次优化设的成本上限 |
| 最少数据量 | 默认 50,范围 0–100000,提示「每次优化至少需要的运行次数,防止数据不足」 |
| 自定义优化提示词 | 占位符「聚焦特定优化方向,留空使用默认模板」 |
| 自动应用建议 | 同常规优化 |
卡片底部有一个 立即执行一次深度优化 按钮,执行中会变成「优化中...」。另外还有「通知」卡(一个开关,开着就「优化完成后推送 WebSocket 消息通知」,这是系统内部的实时通道,你不用管它是什么,知道会收到消息就行)、「排除列表」卡(选哪些 Agent / 技能不参与优化),最后是 保存设置。
页面最下面是「优化报告历史」表,列是 时间 / 层级 / 目标 / 摘要 / 费用(¥) / 操作,层级显示「深度全局」或「常规优化」,操作里有「查看」和「应用」。
十二、超管后台:平台运营方专用的那一套
超管后台是一套独立的界面:进到 /admin 之后,侧边栏换成深色样式,顶部品牌写着 ZY 超管后台(折叠时只显示「超管」),顶栏标题是「超级管理员控制台」。菜单共 7 个页面,外加最后一个 返回用户端(点了回到普通用户的数据面板)。
超管后台的每一个页面都要求「登录 + 是超级管理员」两个条件。如果你不是超管,直接敲网址访问会被自动重定向回数据面板,不会报错也不会泄漏内容。所以看不到它是设计,不是故障。
| 菜单 | 页面标题 | 它能看什么 |
|---|---|---|
| 全局看板 | 全局数据看板 | 全平台的汇总数字:总用户数、活跃项目、实例健康度、累计 Token、累计充值、累计消费、预算消耗速率。右上角可刷新。 |
| 用户管理 | 用户管理 | 用户列表:ID / 邮箱 / 姓名 / 状态 / 超管 / 公司数 / 项目数 / 余额 / 累计消费 / 注册时间 / 操作。操作有三类:详情、封禁 或 解封、重置密码。可按「邮箱/姓名」搜索、按状态筛。 |
| 项目穿透 | 项目穿透查看 | 查看任意用户的项目。点详情弹出 项目详情(只读穿透),顶部一条告警写着 超管只读查看,不可修改用户项目数据;里面显示 ID / 名称 / 状态 / 模式 / 总预算 / 已消耗 / Token 月度 / 近 30 天 Prompt 数,下面还有实例列表。 |
| 实例监控 | 实例监控 | 各项目服务器的运行状况。列:ID / 所属项目 / IP / 云厂商 / 规格 / 区域 / 实例状态 / 心跳状态 / 资源使用率(CPU·内存·磁盘)/ 最后心跳。「实例状态」列现在显示中文(运行中 / 已停止 / 创建中 / 已销毁 / 待创建 / 异常),和上方筛选项口径一致,不再是英文原文。可按状态筛。 |
| Token 统计 | Token 消耗统计 | 累计 Token 数、Token 类消费总额,并可切换统计维度(按模型 / 按用户 / 按项目)看 Top N 消耗排行。 |
| Prompt 审计 | Prompt 审计日志 | 全平台 Prompt 的检索与导出。可按关键词(占位符「全文搜索」)、用户 ID、项目 ID、模型、时间范围筛。列:ID / 用户 / 项目 / 模型 / 角色 / 内容 / Tokens / Agent / 任务 ID / 时间。按钮 查询 和 导出全部(当前筛选)。 |
| 治理审计 | 治理审计汇总 | 报告总数、严重级别分布、报告类型分布、最近严重发现。右上角可刷新。 |
这个页面之前有两个坑,现在都补上了,运营方可以放心用:
- 范围:按钮现在叫 导出全部(当前筛选),导出的是当前筛选条件下的全部记录,不再只是你翻到的那一页。按钮旁有个小问号,悬停会说明「导出范围为当前筛选条件下的全部记录;内容中的手机号/邮箱与屏幕展示同样脱敏」。
- 脱敏:屏幕和导出用同一套口径——手机号中间四位打码(
138****8888)、邮箱 @ 前只留一两位(ab***@x.com)。也就是导出的 CSV 里也是脱敏后的内容,不再出现「屏幕脱敏、导出原文」的漏洞。屏幕上还会对你搜的关键词做高亮。 - 防公式注入:以
=、+、-、@开头的文本会被加一个前导单引号,避免用 Excel / WPS 打开时被当成公式执行。
即便如此,导出的内容仍可能含项目内部信息,请按敏感数据管理,别随手外发。
十三、本章小结与下一步
- 三块结构:顶栏(公司切换器、通知铃铛、主题、用户菜单)、侧边栏(一级菜单)、内容区(页面本体)。
- 10 个一级页面:数据面板、公司管理、项目管理、知识库、AI 对话、公司账本、媒体生成、通知中心、设置,加超管后台。
- 公司切换器是全平台最该先搞懂的控件:它决定知识库 / 项目管理 / 公司管理后四页 / 功能管理能不能用,换公司会清掉「当前项目」。
- 两条账别搞混:公司账本 = 真实资金;项目账本 = 虚拟核算。同一个页面组件、靠网址区分。
- 超管后台是独立的深色界面,只对超级管理员开放,普通账号访问会被弹回。
- 下一步:平台侧的门认完了,去 第 06 章 界面导览(下):项目内页面,看进项目之后那 6 个分组、40 多个页面。
附录 A · 平台侧按钮与入口倒排索引
用法:左边一列是「你想干的事」,右边是「去哪一页、点哪个按钮」。按下表找,不用在界面里瞎点。
| 我想做这件事 | 去哪一页 | 点哪个按钮 / 用什么控件 |
|---|---|---|
| 看全局有多少项目、预算烧了多少 | 数据面板 | 直接看四张指标卡 |
| 看最近的动态 | 数据面板 | 右侧「最近活动」列表 |
| 建一家新公司 | 公司管理 → 公司列表 | 创建公司 |
| 进入某家公司 | 公司管理 → 公司列表 | 该行 进入 |
| 改公司基础信息 | 公司管理 → 公司设置 | 先选中公司,再修改 |
| 看部门 / 层级结构 | 公司管理 → 组织架构 | 先选中公司 |
| 看成员、调角色权限 | 公司管理 → 成员管理 | 先选中公司 |
| 邀请同事加入公司 | 公司管理 → 成员邀请 | 先选中公司 |
| 切换当前公司 | 任意页面 | 顶栏公司下拉,选某家公司或 全部公司 |
| 建一个新项目 | 项目管理 | 新建项目 |
| 进入某个项目干活 | 项目管理 | 点项目卡片 |
| 验证某项目服务器通不通 | 项目管理 | 卡片上的 连接测试 |
| 建一个知识库 | 知识库 → 知识库 | 新建知识库 |
| 往知识库传文档 | 知识库 → 知识库 | 该行 文档管理 → 上传文档 |
| 测试资料能不能被检索到 | 知识库 → RAG 检索 | 输入关键词 → 检索 |
| 删掉一个知识库 | 知识库 → 知识库 | 该行 删除 |
| 开一个新对话问 AI | AI 对话 | 新建对话 |
| 给对话改名 / 删对话 | AI 对话 | 对话右侧下拉 → 重命名 / 删除 |
| 追问时带一个文件 | AI 对话 | 输入区附件按钮,支持 doc/pdf/xlsx/ppt 等 |
| 打断 AI 正在输出的回答 | AI 对话 | 输入区的红色 停止 |
| 给账户充值 | 公司账本 | 充值 |
| 手工记一笔消费 | 公司账本 | 记录消费 |
| 改余额预警线 | 公司账本 | 预警阈值 |
| 按类型 / 分类筛流水 | 公司账本 | 交易明细右上两个下拉 |
| 生成一条视频 | 媒体生成 → 视频 | 生成视频 |
| 生成一张图 | 媒体生成 → 图像 | 生成图像 |
| 生成一首歌 | 媒体生成 → 歌曲 | 填歌词 → 生成歌曲 |
| 看媒体任务花了多少钱 | 媒体生成 → 任务记录 | 看「金额(元)」列 |
| 改各档位单价 | 媒体生成 → 价目设置 | 改数字 → 保存价目 |
| 把消息全部标为已读 | 通知中心 | 全部已读 (N) |
| 只处理未读消息 | 通知中心 | 「已读状态」下拉选「未读」 |
| 删掉一条通知 | 通知中心 | 该条 删除 |
| 切换亮色 / 暗色主题 | 任意页面 | 顶栏主题按钮,或设置 → 个人设置 |
| 激活授权 | 设置 → 授权管理 | 填授权码 → 激活 |
| 开关某个项目的功能 | 设置 → 功能管理 | 选项目 → 拨对应开关 |
| 让 AI 建议开哪些高级功能 | 设置 → 功能管理 | 分析项目并建议 |
| 把功能开关恢复默认 | 设置 → 功能管理 | 重置为默认 |
| 让智能体到一定次数后自动优化 | 设置 → Agent 优化 | 改「运行次数里程碑」→ 保存设置 |
| 立刻做一次深度优化 | 设置 → Agent 优化 | 立即执行一次深度优化 |
| 改深度优化的成本上限 / 数据门槛 | 设置 → Agent 优化 | 改「单次最大费用」「最少数据量」 |
| 看全平台汇总数据(超管) | 超管后台 → 全局看板 | 进入即看,右上角可刷新 |
| 查 / 封禁某个用户(超管) | 超管后台 → 用户管理 | 该行 详情 / 封禁 / 重置密码 |
| 看某个用户的项目(超管) | 超管后台 → 项目穿透 | 查看详情(只读) |
| 看服务器实例健康度(超管) | 超管后台 → 实例监控 | 看「心跳状态」「资源使用率」列 |
| 查某个 Prompt(超管) | 超管后台 → Prompt 审计 | 填筛选 → 查询 |
| 导出 Prompt 记录(超管) | 超管后台 → Prompt 审计 | 导出全部(当前筛选)(与屏幕同口径脱敏) |
| 从超管后台回到普通界面(超管) | 超管后台 | 侧边栏最下 返回用户端 |
附录 B · 平台侧状态与标签全表
本表把平台侧会出现的状态、标签、枚举值集中在一起。界面显示中文,接口层多为英文,排查问题时对着看。
公司、用户与成员
| 类别 | 英文值 | 界面中文 | 出现位置 |
|---|---|---|---|
| 用户状态 | active | 正常 | 超管 → 用户管理 |
| banned | 已封禁 | 超管 → 用户管理 | |
| inactive | 未激活 | 超管 → 用户管理 | |
| 成员角色 | super_admin | 超级管理员 | 成员管理 |
| admin | 管理员 | 成员管理 | |
| member | 普通成员 | 成员管理 | |
| ai_agent | AI Agent | 成员管理 | |
| 公司状态 | active | 正常 | 公司列表「状态」列 |
| 其它 | 已停用 | 公司列表「状态」列 |
项目与实例
| 类别 | 英文值 | 界面中文 | 出现位置 |
|---|---|---|---|
| 项目状态 | draft | 草稿 | 项目卡片 / 超管项目穿透 |
| provisioning | 开通中 | 项目卡片 / 超管项目穿透 | |
| running | 运行中 | 项目卡片 / 超管项目穿透 | |
| paused | 已暂停 | 项目卡片 / 超管项目穿透 | |
| stopped | 已停止 | 项目卡片 / 超管项目穿透 | |
| done | 已完成 | 项目卡片 / 超管项目穿透 | |
| failed | 开通失败 | 项目卡片 / 超管项目穿透 | |
| 运行模式 | full_auto | 全自动 | 项目卡片 / 超管项目穿透 |
| semi_auto | 半自动 | 项目卡片 / 超管项目穿透 | |
| manual | 手动(新建向导写入;自动运营控制台里显示为「人工审核」) | 项目卡片 / 超管项目穿透 | |
| manual_review | 人工审核(自动运营控制台写入;与手动同义,内部值不同,尚未合并) | 项目卡片 / 超管项目穿透 | |
| 实例状态 | running | 运行中 | 超管 → 实例监控(筛选项与表格「实例状态」列均为中文) |
| stopped | 已停止 | 超管 → 实例监控 | |
| creating | 创建中 | 超管 → 实例监控 | |
| terminated | 已销毁 | 超管 → 实例监控 | |
| pending | 待创建 | 超管 → 实例监控 | |
| error | 异常 | 超管 → 实例监控 | |
| 心跳状态 | healthy | 正常 | 超管 → 实例监控 |
| degraded | 降级 | 超管 → 实例监控 | |
| down | 宕机 | 超管 → 实例监控 | |
| unknown | 未知 | 超管 → 实例监控 |
知识库与文档
| 类别 | 英文值 | 界面中文 | 出现位置 |
|---|---|---|---|
| 知识库类型 | company | 公司级 | 知识库 / 新建知识库 |
| project | 项目级 | 知识库 / 新建知识库 | |
| shared | 共享 | 知识库 / 新建知识库 | |
| 知识库状态 | active | 正常 | 知识库列表 |
| indexing | 索引中 | 知识库列表 | |
| error | 错误 | 知识库列表 | |
| 文档状态 | uploaded | 待处理 | 文档管理抽屉 |
| parsing | 解析中 | 文档管理抽屉 | |
| parsed | 已解析 | 文档管理抽屉 | |
| chunking | 分块中 | 文档管理抽屉 | |
| embedding | 向量化中 | 文档管理抽屉 | |
| ready | 就绪 | 文档管理抽屉 | |
| error | 失败 | 文档管理抽屉 |
账本与媒体
| 类别 | 英文值 | 界面中文 | 出现位置 |
|---|---|---|---|
| 平台流水类型 | recharge | 充值 | 公司账本 |
| consume | 消费 | 公司账本 | |
| refund | 退款 | 公司账本 | |
| 平台流水分类 | server | 云服务器费 | 公司账本 |
| token | Token 费 | 公司账本 | |
| image | 图片生成费 | 公司账本 | |
| video | 视频生成费 | 公司账本 | |
| other | 其它 | 公司账本 | |
| 媒体任务状态 | submitted | 已提交 | 媒体生成 → 任务记录 |
| queued | 排队中 | 媒体生成 → 任务记录 | |
| preparing | 准备中 | 媒体生成 → 任务记录 | |
| running | 生成中 | 媒体生成 → 任务记录 | |
| succeeded | 已完成 | 媒体生成 → 任务记录 | |
| failed | 失败 | 媒体生成 → 任务记录 | |
| timeouted | 已超时 | 媒体生成 → 任务记录 | |
| cancelled | 已取消 | 媒体生成 → 任务记录 | |
| expired | 已过期 | 媒体生成 → 任务记录 |
通知与授权
| 类别 | 英文值 | 界面中文 | 出现位置 |
|---|---|---|---|
| 通知优先级 | urgent | 紧急 | 通知中心 |
| important | 重要 | 通知中心 | |
| normal | 普通 | 通知中心 | |
| info | 信息 | 通知中心 | |
| 通知类型 | budget_alert | 预算预警 | 通知中心 |
| approval_required | 审批请求 | 通知中心 | |
| task_complete | 任务完成 | 通知中心 | |
| campaign_update | 营销更新 | 通知中心 | |
| milestone | 里程碑 | 通知中心 | |
| system | 系统通知 | 通知中心 | |
| marketing | 营销通知 | 通知中心 | |
| 激活状态 | authorized | 已激活 | 设置 → 授权管理 |
| trial | 试用中(未激活) | 设置 → 授权管理 | |
| grace | 离线宽限 | 设置 → 授权管理 | |
| expired | 已过期 | 设置 → 授权管理 |
附录 C · 全局交互速查:加载、空态、报错、分页
平台侧各页面的「非正常状态」文案是统一的套路。认熟这几句,你就能一眼判断「是没数据、还是出错了、还是我没选对上下文」。
三类「空」要分清
| 你看到的 | 真实含义 | 该怎么办 |
|---|---|---|
| 暂无 XXX(如「暂无项目流水」「暂无交易记录」「暂无通知」) | 一切正常,就是这条数据还没有 | 不用管,等有数据就会自己出现 |
| 请先在顶部选择公司 | 你把公司切换器留在了空闲状态 | 去顶栏选一家公司 |
| 请先选择或创建一个公司 | 同上,出现在项目管理页 | 去顶栏选公司,或先去公司管理建一家 |
| 请先选择一个项目以管理其功能开关 | 公司选好了,但这家公司还没有项目 | 先去项目管理建一个项目 |
| 暂无公司,点击右上角创建 | 一家公司都还没有 | 点右上角 创建公司 |
加载与出错文案
| 界面文案 | 含义与处理 |
|---|---|
| 加载图表数据... | 数据面板的图表正在拉数据,等一下就好 |
| 加载看板数据失败 | 数据面板整体拉取失败,多数是网络抖动,刷新页面重试 |
| 请求超时,请稍后重试 | 读操作超过 15 秒没响应。稍等再试,或检查网络 |
| 请求超时,该操作可能已在服务端生效,请先刷新确认结果,再决定是否重试 | 写操作(提交、保存、新建、删除等)超时。这类请求可能其实已经成功了,只是回执没回来,所以别急着重复点——先刷新看结果,避免重复充值 / 重复建任务 |
| 网络异常,请检查连接 | 读操作请求根本没发出去或被中断。检查网络 / 代理 |
| 网络异常,该操作可能已在服务端生效,请先刷新确认结果,再决定是否重试 | 写操作断网,同上:先刷新确认,再决定要不要重来 |
| 上游服务暂时不可达(502),请稍后重试;如持续出现请查看实例状态 | 项目服务器连不上(网关返回 502)。先确认实例在不在线,稍后重试。若后端透传了具体原因(如「实例未就绪」),会优先显示那句 |
| 上游服务暂时不可用(503),可能正在重启或过载,请稍后重试 | 项目服务器正在重启或过载(503)。等一两分钟再试 |
| 上游服务响应超时(504),请稍后重试;如持续出现请查看实例状态 | 项目服务器响应超时(504)。稍后重试,持续出现就去看实例状态 |
| 无权限访问 | 后端返回了 403。你的角色没有这个操作的权限 |
| ××功能未启用,请在功能开关中开启 KEY | 该项目对应功能的开关是关的。去设置 → 功能管理把它打开(见本章第十一节) |
| 正在重新登录 / 跳回登录页 | 登录态失效(未认证 / Token 无效 / Token 过期)会自动跳登录页,登录后回到原页面 |
| 项目列表加载失败 / 功能开关加载失败 | 功能管理页的项目列表或开关拉取失败,后面跟具体原因,并带一个「重试」链接——点它重试,不用整页刷新 |
| 操作失败: ××× / 重置失败: ××× / 获取建议失败: ××× | 功能管理页每个动作失败都会带前缀,后面跟具体原因 |
只有「登录态本身失效」这一类(未认证、Token 无效、Token 过期)才会自动跳登录页,并且会记住你原本要去哪,登录后送你回去。而像「登录失败」「该用户名已存在」「账号被封禁」这类,是在当前页面原地显示错误,不会把你踢走。所以如果你改了密码后在别处登录、这边被踢回登录页,是正常的。
分页
记录多的列表(公司账本交易明细、Prompt 审计等)底部有分页条,形如「共 N 条 上一页 页码 下一页」。公司账本用的是最简的一种:只显示总条数 + 上页 / 页码 / 下页。
附录 D · 界面上的数字从哪来
这一节回答一个容易被忽略但很容易造成误判的问题:你屏幕上那些数字,各自代表什么、边界在哪。看懂它,你就不会误把「汇总值」当「实时值」。
数据面板四张卡
| 卡片 | 数字含义 | 注意 |
|---|---|---|
| 项目概览 | 你能看到的项目个数 | 切到「全部公司」时是跨公司汇总,切到某家公司时只看这一家 |
| 预算消耗 | 已用预算 ÷ 总预算,换算成百分比 | 跨多个项目时看的是整体比例,不代表某一个项目 |
| 任务状态 | 处于运行中 / 开通中状态的项目数(卡片标题写作「任务状态」) | 口径与字面不一致:它数的是「项目」,不是「任务条数」,也不含已完成 / 失败的项目 |
| Agent 执行 | 开通与运维记录的累计条数 | 是记录条数,不是「几个智能体」,也不等同于智能体调用次数 |
公司账本的四个数
| 字段 | 它是什么 | 边界 |
|---|---|---|
| 当前余额 | 账户可用额度(可用额度) | 真实资金,余额见底会触发实例熔断 |
| 累计充值 | 历史累计充进来的钱 | 只增不减 |
| 累计消费 | 历史累计花掉的钱 | 只增不减 |
| 预警阈值 | 低于它就说一声 | 你可以在 预警阈值 里改 |
公司账本记的是真实资金;项目内的「计费明细」记的是这个项目虚拟核算的花销。两者口径不同,不要交叉相减。AI token 消耗现在会由项目侧批量上报进公司账本(见第八节的提醒),但前提是部署时配好了上报地址——没配的实例,公司账本不含 AI 算力费,这一点账本页也有常显说明。做经营分析仍以项目账本的「计费明细」为准,做资金核对以公司账本为准。
媒体生成的钱
任务记录里的「金额(元)」由服务端按「档位单价 × 用量」折算,计入项目账本。如果你没给某个档位设置单价,那条记录会显示 待定价,金额不折算——这不是系统算错了,而是「宁可空着也不编一个数」。想让它有数,去「价目设置」填上单价。
超管后台的统计
Token 统计页的两种维度讲清楚:累计 Token 数是消耗掉的 token 总量,Token 类消费总额是这些 token 折算成的钱。它还能切换「按模型 / 按用户 / 按项目」看 Top N 排行——用来回答「谁在烧」「哪个模型贵」这类问题。全局看板里的「预算消耗速率」是一个趋势指标,表示当前花钱的速度,比单看「花了多少」更能提前发现问题。
养成每周扫一眼「通知中心(预算预警类)」+「公司账本(余额与累计消费)」的习惯。这两个地方是最早能发现「钱不对劲」的位置,比等盯项目内的计费明细更提前。